home *** CD-ROM | disk | FTP | other *** search
/ Megahits 5 / Megahits 5 (1994)(GTI - Rhein-Main-Soft)(DE)(Disc 2 of 2)[!].iso / archive / show / superview_lib6_3.lha / superview-lib / Docs / SVDriver-Docs / AGA.doc next >
Text File  |  1994-06-06  |  4KB  |  150 lines
  1.  
  2.   AGA.svdriver
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 1.7
  9.   Release Date : 07.05.1994
  10.  
  11.  
  12.   Requirements
  13.   ~~~~~~~~~~~~
  14.   - OS V3.00+ (V39)+ and its libraries
  15.   - superviewsupport.library V1+
  16.  
  17.  
  18.   Description
  19.   ~~~~~~~~~~~
  20.   AGA.svdriver is an external Library-Module for the superview.library V3+.
  21.  
  22.   It supplies functions for V2+ SVObjects to allow object-orientated
  23.   displaying of graphics on AGA Screens.
  24.  
  25.   The internal graphics interchange format is the same as supported by
  26.   superview.library V3+ in connection with V2+ SVObjects, which can be
  27.   used by external custom programs.
  28.  
  29.   AGA.svdriver is identical to ECS.svdriver, except to the "chunky pixel"
  30.   support and other features, which have been realized with V39 functions
  31.   here.
  32.  
  33.   This Driver supports the following :
  34.  
  35.   Dimensions        Depth      Type
  36.  
  37.   [AGA]         [AGA]      BITPLANE
  38.   [AGA]         8          ONEPLANE    (Chunky Pixel)
  39.  
  40.   ONEPLANE 24 Bit Graphics (RGB 3x8-ONEPLANE) will be dithered to 8 Bit.
  41.  
  42.   Autoscrolling of Screens larger than the actual display is supported :
  43.   Just move the mouse to the boundings !
  44.  
  45.  
  46.   Author
  47.   ~~~~~~
  48.   Andreas R. Kleinert
  49.   Grube Hohe Grethe 23
  50.   D-57074 Siegen
  51.   Germany
  52.  
  53.  
  54.   Known Bugs
  55.   ~~~~~~~~~~
  56.   This bug only concerns to File-Formats in which pictures with only
  57.   2 Colors may be represented as Chunky-Pixel data, e.g. :
  58.  
  59.    - 2-Color GIF87a/89a
  60.    - 2-Color IMG
  61.    - 2-Color BMP
  62.    - 2-Color FBM
  63.  
  64.   This bug does not occur always : Whether you get it or not depends on
  65.   the actual width of the image in the file.
  66.   For example a 354x410x1 graphics from a BMP File will as well cause
  67.   problems as a 694x136x1 FBM graphics file.
  68.  
  69.   What do these have in common ?
  70.  
  71.    - they are written to the RastPort via WritePixelLine8(), using
  72.      a TmpRas-Structure with attached BitMap
  73.    - they will both be displayed on a Screen, which actually has a larger
  74.      width than the display itself (320 <-> 354 and 640 <-> 694), so
  75.      that the Autoscroll-feature has to be used
  76.    - both width values do not exactly end on byte-, word- or longword-
  77.      boundaries
  78.  
  79.   Due to the fact, that all other graphics, with the same width and
  80.   height, but other color-depth and/or bitplane organization (no
  81.   WritePixelLine8() needed) are displayed correctly, I believe
  82.   that this is the result of a bug in the OS V39, maybe also V37.
  83.   Perhaps WritePixelLine8() is not fully free of bugs yet.
  84.  
  85.   Try using other programs with some "critical" graphics and I guess,
  86.   that you will get the same results like with this SVDriver :
  87.  
  88.    - either the system will slow down very much (silent crash)
  89.    - or after closing the display and freeing all memory : problems
  90.      with the memory list will be reported by exec (Recoverable or
  91.      DeadEnd Alert) when using "avail flush"
  92.  
  93.  
  94.   History
  95.   ~~~~~~~
  96.   V1.7 (22.05.1994) :
  97.  
  98.    - fixed small bug in 24-Bit-Support :
  99.      our single temporary bitplane line always had a PlaneDepth of 24,
  100.      so that 16 planes were wasted useless :-(
  101.      Now this memory is saved and also speed may increase.
  102.  
  103.  
  104.   V1.6 (07.05.1994) :
  105.  
  106.    - use of SAS/C V6.51
  107.    - use of new "superviewsupport.library" V1
  108.      This saves some space again (here : ca. 400 Bytes).
  109.    - version still reflected 1.4 instead 1.5. Now we're at 1.6 :-)
  110.  
  111.  
  112.   V1.5 (30.04.1994) :
  113.  
  114.    - fixed small bug in memory delocation (when multiply called)
  115.  
  116.  
  117.   V1.4 (18.04.1994) :
  118.  
  119.    - improved internal "regular case" BitMap-to-BitMap routine
  120.    - added code for dithering 24 Bit RGB-Oneplane pictures
  121.      (is quite slow, but results in good pictures)
  122.  
  123.  
  124.   V1.3 (25.03.1994) :
  125.  
  126.    - slightly improved internal BitMap-to-BitMap routine
  127.    - removed bug-fix from V1.2, now using BMF_DISPLAYABLE flag, no matter
  128.      if this will help or not
  129.  
  130.  
  131.   V1.2 (19.03.1994) :
  132.  
  133.    - tried to fix bug with strange-sized (temporary) bitmaps like 694x136 :
  134.      now uses size = (((x + 15) >> 4) << 4) for determinating the
  135.      desired width.
  136.      This is not completely fixed yet (seems to be an OS bug ...)
  137.  
  138.  
  139.   V1.1 (09.03.1994) :
  140.  
  141.    - first version
  142.  
  143.  
  144.   Copyrights
  145.   ~~~~~~~~~~
  146.   Some of the mentioned names or products above may be copyrighted by
  147.   companies or trademarks of companies.
  148.  
  149.  
  150.